.TH "nvme_identify_nsid_ctrl_list" 9 "nvme_identify_nsid_ctrl_list" "July 2025" "libnvme API manual" LINUX
.SH NAME
nvme_identify_nsid_ctrl_list \- Retrieves controller list attached to an nsid
.SH SYNOPSIS
.B "int" nvme_identify_nsid_ctrl_list
.BI "(int fd "  ","
.BI "__u32 nsid "  ","
.BI "__u16 cntid "  ","
.BI "struct nvme_ctrl_list *cntlist "  ");"
.SH ARGUMENTS
.IP "fd" 12
File descriptor of nvme device
.IP "nsid" 12
Return controllers that are attached to this nsid
.IP "cntid" 12
Starting CNTLID to return in the list
.IP "cntlist" 12
User space destination address to transfer the data
.SH "DESCRIPTION"
Up to 2047 controller identifiers are returned containing a controller
identifier greater than or equal to the controller identifier  specified in
\fIcntid\fP attached to \fInsid\fP.

See \fIstruct nvme_ctrl_list\fP for a definition of the structure returned.
.SH "RETURN"
The nvme command status if a response was received (see
\fIenum nvme_status_field\fP) or -1
